GameMaster MCP Server — Complete

ALL 4 PHASES IMPLEMENTED ✅ Created: 2026-05-17

Architecture

Hermes ──→ GameMaster MCP Server (FastMCP) ──→ GameMaster Agent
                        │
External apps ──→ (Caveduck, Tipsy, etc.)

• Lilith stays as dark fantasy goddess brand — NOT a worker
• GameMaster = functional agent, SEPARATE from Lilith

12 MCP Tools

Tool	Phase	Description
ideate_characters	1	Generate concepts (7 genres)
create_character_sheet	1	Full Caveduck-compatible sheet
analyze_trending	1	Platform trending + gaps
suggest_tags	1	Optimal tags (max 10, Original first)
generate_character_image	3	ComfyUI card gen (4 styles, 3 checkpoints)
list_available_checkpoints	3	Show VRAM, SFW/NSFW
get_platform_requirements	2	Official Caveduck field specs
score_character	4	Quality scoring (S/A/B/C/D)
get_prompt_hints	4	LLM prompts for templates
check_character_exists	4	Duplicate name check
get_creation_stats	4	Registry stats
register_character	4	Record character in memory

Key Caveduck Discoveries (Official Docs May 2026)

• Description: 10,000 chars (NOT 200!)
• Greeting: 3 variants × 10,000 chars each
• Secret: 10,000 chars — adds mystery and engagement
• Tags: max 10 — "Original" tag first = 6.6x more chats
• Lorebook: 100 keywords, 10 active per conversation
• Variables: 3 per character (Intimacy, Trust, etc.)
• Writing Style: Even 1-2 sentences can define personality
• Original Character: 6.6x more chats, higher incentive rates
• Cash: 20,000 incentives = $100 USDC

Files

• Package: /mnt/d/Proyectos/Yggdrasil/Vanaheim/gamemaster-mcp-server/
• Skill: gamemaster-agent (Hermes skill)
• Obsidian: This file
• Character memory: ~/.hermes/gamemaster_memory/characters.json

Next Steps

• Register as MCP server in Hermes config for direct tool access
• Browser automation for Caveduck character upload (Phase 2+)
• ComfyUI card generation testing (needs ComfyUI running)
• pydantic-ai agent loop for LLM-powered creative generation